package com.screen.screendisplay.service.coal;

import com.screen.screendisplay.entity.coal.CoalProdoperOsv;
import com.screen.screendisplay.vo.coal.CoalStrippingVO;
import com.screen.screendisplay.vo.coal.CoalStrippingUnitsVO;
import com.screen.screendisplay.vo.coal.CoalStrippingTrendVO;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

/**
 * <p>
 * 生产经营土岩剥离量表 服务类
 * </p>
 *
 * @author xuesong
 * @since 2025-08-23
 */
public interface CoalProdoperOsvService extends IService<CoalProdoperOsv> {

    /**
     * 获取土岩剥离量完成情况
     * @param year 年份，如果为null则使用当前年份
     * @return 土岩剥离量VO
     */
    CoalStrippingVO getStripping(Integer year);

    /**
     * 获取各单位土岩剥离量完成情况
     * @param year 年份，如果为null则使用当前年份
     * @return 各单位土岩剥离量列表
     */
    List<CoalStrippingUnitsVO> getStrippingByUnits(Integer year);

    /**
     * 获取土岩剥离量完成趋势
     * @param year 年份，如果为null则使用当前年份，返回最近5年数据
     * @return 土岩剥离量趋势列表
     */
    List<CoalStrippingTrendVO> getStrippingTrend(Integer year);

}
